Amiga Tools 2/Amiga Tools 2.iso/tex/macros/source/packages/epic/picman.tex/node4_mn.html

Text File | 1995-03-15 | 4KB | 82 lines

<H2><A ID="SECTION00031000000000000000">
<TT>\</TT>multiputlist</A>
</H2>

<P>
<#456#><TT>SYNOPSIS:
<BR> \multiputlist(<I>x</I>,<I>y</I>)(<I>Δx</I>,<I>Δy</I>)[tbrl]<tex2html_comment_mark>16
{<#48#><I>item1</I><#48#>,<#49#><I>item2</I><#49#>,<#50#><I>item3</I><#50#>,...,<#51#><I>itemN</I><#51#>}</TT><#456#>

<P>
This command is a variation of the regular L<SUP><SMALL>A</SMALL></SUP>T<SMALL>E</SMALL>X command <tex2html_verb_mark>12<tex2html_verb_mark>.
The <tex2html_verb_mark>13<tex2html_verb_mark> command permits one to put the <#52#><I>same</I><#52#> object
at regularly spaced coordinates. Often one wishes to put <#53#><I>different</I><#53#>
objects at coordinates that have regular increments -- <tex2html_verb_mark>14<tex2html_verb_mark>
command can be used in those cases. This command enables one to specify a
collection of objects with a single command thus simplifying the task of
calculating coordinates. All those objects may also be plotted separately
using <tex2html_verb_mark>15<tex2html_verb_mark> commands, but any future revision of those coordinates
may involve lot of manual work. This command also encourages certain
regularity and symmetry in laying out various objects in a picture.

<P>
In the <tex2html_verb_mark>16<tex2html_verb_mark>, as the coordinates are incremented, the objects
to be put are picked up from the <#54#><I>list of items</I><#54#>,
i.e., first item in first position, second item in second position, and so on.
For example, numbers along the X-axis in a graph may be plotted by simply
specifying:<BR> <tex2html_verb_mark>17<tex2html_verb_mark> <BR>This is almost equivalent to the sequence:
<BLOCKQUOTE>
</BLOCKQUOTE><PRE><tex2html_verbatim_mark>verbatim63#</PRE><BLOCKQUOTE>
</BLOCKQUOTE>

<P>
The difference is that each <#60#><I>item</I><#60#> is put in a
<tex2html_verb_mark>18<tex2html_verb_mark> kind of construction which
allows the specification of
the reference point of the box containing the item. The <tex2html_verb_mark>19<tex2html_verb_mark>
is optional and its absence makes the item centered at the specified
coordinate. Note that <tex2html_verb_mark>20<tex2html_verb_mark> command does not have such an option.

<P>
The objects in the <#61#><I>list</I><#61#> can be virtually anything including any
<tex2html_verb_mark>21<tex2html_verb_mark>, <tex2html_verb_mark>22<tex2html_verb_mark>, math characters, etc. This command can be
usefully employed in a situation where a variety of objects are
to be put at coordinates that have a regular increment along the x-axis and
the y-axis.

<P>
Few comments about <tex2html_verb_mark>23<tex2html_verb_mark> command:

<P>

<UL>
<LI>Individual items have to be grouped in <tex2html_verb_mark>24<tex2html_verb_mark> if they contain ``,''s.

<P>
</LI>
<LI>In the list of items, blanks are not ignored (of course, consecutive
blanks are coalesced into one, as always). For a list of items longer than a
line of input, put a <tex2html_percent_mark> at the end in order to nullify the newline if a
blank is not intended to be a part of the item.

<P>
</LI>
<LI>Specifying individual items in a list format provides a powerful
mechanism for specifying a variety of objects in a single command.
Moreover, often real numbers need to be plotted and
it is nontrivial to generate real numbers or otherwise
handle them in T<SMALL>E</SMALL>X; they need to be explicitly specified as <#63#><I>objects</I><#63#> in
the desired format.
The <tex2html_verb_mark>25<tex2html_verb_mark> command somewhat simplifies such a task.

<P>
</LI>
<LI>The implementation of <tex2html_verb_mark>26<tex2html_verb_mark> uses two macros derived from
the ones given in the T<SMALL>E</SMALL>Xbook, namely, <tex2html_verb_mark>27<tex2html_verb_mark> and <tex2html_verb_mark>28<tex2html_verb_mark> for
list-manipulation.
</LI>
</UL>

<P>